home *** CD-ROM | disk | FTP | other *** search
/ C/C++ 3D Game Tools / C-C++ 3D Game Tools.iso / ziptools / arj / mtapvf41.arj / MTA_DPMI.DOC < prev    next >
Encoding:
Text File  |  1993-08-08  |  12.7 KB  |  274 lines
  1. ╔══════════════════════════════                 ┌─────────────────┐
  2. ║ MTA       Make Them Anything                  │    D.I.S.P.     │────┐
  3. ║           Convert Compressed                  │                 │░░░░│
  4. ╟──────────────────────────────                 │                 │░░░░│
  5. ║ (c) 1993  Robert W.van Hoeven                 │ Dutch           │░░░░│
  6. ╟──────────────────────────────                 │   Independent   │░░░░│
  7. ║ Release : 15.41                               │     ShareWare   │░░░░│
  8. ║ Rel.Date: August, 8th, 1993                   │       Programmer│░░░░│
  9. ╠══════════════════════════════                 └─────────────────┘░░░░│
  10. ║                                               |    │░░░░░░░░░░░░░░░░░│
  11. ║                                               |    └─────────────────┘
  12. ║                                               |       ┌─────┐        |
  13. ║                                               |       │░░░░░│        |
  14. ║                                               |       └──┬──┘        |
  15. ║                                               |     ┌────┴────┐      |
  16. ║                                               ------││││││ ═══│-------
  17. ║                                                     └─────────┘
  18. ║
  19. ║
  20. ║
  21. ╠═══════════════════════════════
  22. ║ Address: Robert W. van Hoeven
  23. ║          PO. Box 131
  24. ║          1170 AC  Badhoevedorp
  25. ║          Nederland / Holland
  26. ╚═══════════════════════════════
  27.  
  28.  ┌───────┬─────────────────────────────────────────────────────────────┐
  29.  │   0   │ Table of contents                                           │
  30.  └───────┴─────────────────────────────────────────────────────────────┘
  31.  
  32.  1 ----    MTA protected-mode version (MTADPMI.EXE)
  33.   1.1      Files contained in this archive
  34.   1.2      Running MTA in protected-mode
  35.   1.3      Protected Mode and Memory
  36.     1.3.1  DPMIINST
  37.     1.3.2  DPMIMEM
  38.     1.3.2  RTMRES
  39.     1.3.2  Extended Memory
  40.   1.4      Running MTADPMI from Windows
  41.   1.5      Running MTADPMI in Windows Standard Mode
  42.   1.6      Running MTADPMI from a Windows DOS prompt
  43.   1.7      Controlling the Amount of memory the Run-Time Manager uses
  44.   1.8      Important note for Borland C++ and Paradox 4.0 users
  45.   1.9      Important note for multi-tasking users
  46.  
  47.  ┌───────┬─────────────────────────────────────────────────────────────┐
  48.  │   1   │ MTA protected-mode version (MTADPMI.EXE)                    │
  49.  └───────┴─────────────────────────────────────────────────────────────┘
  50.  
  51.  1.1 Files contained in this archive
  52.  ────────────────────────────────────
  53.  MTADPMI.EXE  (the  protected-mode  version  of  MTA.EXE) can be used on
  54.  80286 and higher  machines. To run  MTADPMI, you need  some extra files
  55.  which  are  included  in  a  separate  archive. You should extract this
  56.  separate  archive  (MTA__RTL.???)  first  before  you continue with the
  57.  remainder of this document.
  58.  
  59.  The MTA__RTL.??? archive contains the following files:
  60.  
  61.  RTM.EXE      - the Borland International DPMI Run-Time Manager
  62.  RTMRES.EXE   - the Borland International DPMI Resident Run-Time Manager
  63.  DPMI16BI.OVL - The Borland International DPMI Overlay File
  64.  DPMIINST.EXE - Configures RTM.EXE to your system specifications
  65.  
  66.  
  67.  1.2 Running MTA in protected-mode
  68.  ────────────────────────────────────
  69.  When you run MTA as  a protected-mode application (use the  MTADPMI.EXE
  70.  version  you  obtained),  you  must  ensure that DPMI16BI.OVL (the DPMI
  71.  server), and RTM.EXE (the run-time manager) are present in the  current
  72.  directory, the same directory as the application, or on the DOS path.
  73.  
  74.  
  75.  1.3 Protected Mode and Memory
  76.  ────────────────────────────────────
  77.  A DOS protected-mode program  uses DPMI (DOS Protected  Mode Interface)
  78.  to run  in protected  mode which  gives the  application access  to all
  79.  your  computer's  memory.  With  the  exceptions  outlined  in the next
  80.  paragraphs  below,  the  DOS  protected-mode  technology  is completely
  81.  transparent  and  no  extra  steps  are  necessary  in  order  to run a
  82.  protected-mode application.
  83.  
  84.  
  85.  1.3.1 DPMIINST
  86.  ────────────────────────────────────
  87.  One such exception might be  when you run a protected-mode  program for
  88.  the  very  first  time  on  a  286-based  system.  The  protected  mode
  89.  technology uses  an internal  database which  contains various  machine
  90.  characteristics to determine how to enable protected mode operation  on
  91.  your system, and configures itself accordingly. If you have a  computer
  92.  with  an  older  80286  microprocessor,   your  system  might  not   be
  93.  recognized.  You'll  see   this  message  when   you  try  to   run   a
  94.  protected-mode application:
  95.  
  96.  'Machine not in database (RUN DPMIINST)'
  97.  
  98.  If you  get this  message, simply  run the  DPMIINST program  by typing
  99.  DPMIINST at the DOS prompt and following the program's instructions.
  100.  
  101.  DPMIINST runs your machine through  a series of tests to  determine the
  102.  best  way  of  enabling  protected  mode,  and automatically configures
  103.  accordingly.  Once  you  have  run  DPMIINST,  you won't have to run it
  104.  again.
  105.  
  106.  Some  memory  managers,  device  drivers,  and  memory-resident   (TSR)
  107.  programs can interfere with DPMIINST's ability to analyze your  system.
  108.  If  DPMIINST  fails,  try  temporarily  disabling  or  removing   these
  109.  programs.  That  gives  DPMIINST  the  unrestricted  access it needs to
  110.  determine the best way to enter protected mode.
  111.  
  112.  Note that  running DPMIINST.EXE  will never  be required  on any system
  113.  running HIMEM (or equivalent)  or on any system  based on an 80386  (or
  114.  later) processor.
  115.  
  116.  
  117.  1.3.2 DPMIMEM
  118.  ────────────────────────────────────
  119.  By default, the DPMI interface allocates all available extended  memory
  120.  for its own use.  If you don't want  all of the available  memory to be
  121.  taken by the  DPMI kernel, you  can set a  DOS environment variable  to
  122.  specify  the  maximum  amount  of  memory  to use. This variable can be
  123.  entered directly  at the  DOS prompt  or inserted  in your AUTOEXEC.BAT
  124.  file, using this syntax:
  125.  
  126.  SET DPMIMEM=MAXMEM nnnn
  127.  
  128.  where nnnn is the amount of memory in kilobytes.
  129.  
  130.  For example, if you have a system with 4MB and want the DPMI kernel  to
  131.  use only 2MB of it, leaving  the other 2MB alone, the DPMIMEM  variable
  132.  would be set as follows:
  133.  
  134.  SET DPMIMEM=MAXMEM 2048
  135.  
  136.  Some memory managers, like QEMM  or 386^Max, allow allocating the  same
  137.  area  of  memory  as  either  extended  or  expanded  and  many   older
  138.  applications can use only expanded  memory (EMS). By using the  DPMIMEM
  139.  DOS environment variable  to limit the  amount of extended  memory used
  140.  by  the  DPMI  server,  your  system  will  still  have expanded memory
  141.  available for use by older applications.
  142.  
  143.  
  144.  1.3.2 RTMRES
  145.  ────────────────────────────────────
  146.  RTMRES preloads the protected-mode  system. Preloading the DPMI  server
  147.  lets you load  a protected-mode program  slightly faster.   RTMRES will
  148.  start a program  if you specify  a program name  as a parameter.  If no
  149.  parameter  is  specified,  RTMRES  will  run  a DOS shell. Type EXIT to
  150.  close the shell.
  151.  
  152.  RTMRES  is  especially  useful  if   you  start,  exit,  and  start   a
  153.  protected-mode  program  frequently.  Normally,  every  time  you run a
  154.  protected-mode application, the  DPMI server is  loaded. If you've  run
  155.  RTMRES   previously,   the   server   is   already   present,  and  the
  156.  protected-mode application loads faster.
  157.  
  158.  
  159.  1.3.2 Extended Memory
  160.  ────────────────────────────────────
  161.  A protected-mode  application interacts  with the  DPMI server  through
  162.  Borland's  run-time  manager  (RTM.EXE).  By  default, a protected-mode
  163.  application uses all the extended memory reserved by the DPMI kernel.
  164.  
  165.  
  166.  1.4 Running MTADPMI from Windows
  167.  ────────────────────────────────────
  168.  A DOS protected-mode program will run in Windows in 386 enhanced  mode.
  169.  To configure the amount of memory available to the application,  create
  170.  a Windows PIF file. To learn  more about PIF files, see your  Microsoft
  171.  Windows User's Guide.
  172.  
  173.  
  174.  1.5 Running MTADPMI in Windows Standard Mode
  175.  ────────────────────────────────────────────
  176.  In order to  run a protected-mode  program from Windows  standard-mode,
  177.  you must set the DPMIMEM DOS environment variable and run RTMRES  (both
  178.  are described above)  before running Windows.   Make sure your  DPMIMEM
  179.  setting leaves enough physical memory for Windows to operate.
  180.  
  181.  Note that once you've run RTMRES,  you won't be able to run  Windows in
  182.  386 enhanced mode until you exit the RTMRES shell (by typing EXIT at  a
  183.  DOS prompt).
  184.  
  185.  
  186.  1.6 Running MTADPMI from a Windows DOS prompt
  187.  ─────────────────────────────────────────────
  188.  To run a DOS protected-mode application from a Windows DOS prompt,  you
  189.  must  first  modify  the  DOSPRMPT.PIF  file  found  in  your   Windows
  190.  directory  so  that  the  protected-mode  program  will  be able to use
  191.  extended memory.
  192.  
  193.  Using the Windows PIF editor, open the DOSPRMPT.PIF file, and  indicate
  194.  the amount of  extended memory you  want the protected-mode  program to
  195.  use. If you are  unsure how to use  the PIF editor, see  your Microsoft
  196.  Windows User's Guide.
  197.  
  198.  
  199.  1.7 Controlling the Amount of memory the Run-Time Manager uses
  200.  ──────────────────────────────────────────────────────────────
  201.  The run-time manager  attempts to free  as much conventional  memory as
  202.  possible (by moving  moveable memory blocks  into extended memory,  for
  203.  example) before starting an application. No attempt is made to  release
  204.  extended memory,  however. Therefore,  if you  are going  to run  other
  205.  protected-mode  applications  that  don't  use  the  run-time   manager
  206.  (Paradox 4.0,  for example),  use the  RTM DOS  environment variable to
  207.  control the run-time manager's allocation of memory.
  208.  
  209.  Use the DOS command  line to add the  RTM environment variable to  your
  210.  system's DOS environment. Here is the syntax:
  211.  
  212.  SET RTM=[option nnnn]
  213.  
  214.  The  following  table  lists  the  options  you  can use. nnnn can be a
  215.  decimal number or a hex number in the form of xAB54 or xab54.
  216.  
  217.  Option          Description
  218.  -------------------------------------------------------------
  219.  EXTLEAVE nnnn   Always   leave  at  least   nnnn kilobytes of  extended
  220.                  memory available. The default value is 640K.
  221.  
  222.  EXTMAX nnnn     Don't  allocate more than  nnnn kilobytes of   extended
  223.                  memory. The default value  is 4 gigabytes. In  Windows,
  224.                  the default value is one-half the available memory.
  225.  
  226.  EXTMIN nnnn     If  fewer   than  nnnn kilobytes  are available   after
  227.                  applying EXTMAX and EXTLEAVE limits, terminate with  an
  228.                  Out of Memory message. The default value is zero.
  229.  
  230.  REALLEAVE nnnn  Always leave at  least nnnn paragraphs  of real  memory
  231.                  available.   The   default   value   is   64K  or  4096
  232.                  paragraphs.
  233.  
  234.  REALMAX  nnnn   Don't  allocate  more   than  nnnn paragraphs of   real
  235.                  memory.  The  default  value  is  1  megabyte or 65,535
  236.                  paragraphs.
  237.  
  238.  REALMIN nnnn    If fewer   than nnnn  paragraphs are  available   after
  239.                  applying REALMAX and  REALLEAVE, terminate with  an Out
  240.                  of Memory message. The default value is zero.
  241.  
  242.  The following DOS  command limits RTM  to 2M bytes  of extended memory,
  243.  and ensures that 128K bytes of real memory are left unallocated:
  244.  
  245.  SET RTM=EXTMAX 2048 REALLEAVE 8192
  246.  
  247.  
  248.  1.8 Important note for Borland C++ and Paradox 4.0 users
  249.  ──────────────────────────────────────────────────────────────
  250.  The  DPMILOAD.EXE  and  DPMI16BI.OVL  files  provided  in  this package
  251.  replace the  older ones  that came  with Paradox  4.0 and  BC++ 3.0  or
  252.  later. Delete  or rename  the older  versions and  make sure  the newer
  253.  ones are on  your DOS path  (both Paradox and  BC will search  the path
  254.  and find the newer versions).
  255.  
  256.  If  you  plan  to  shell  out  from  Paradox  or  BC++  to  run another
  257.  protected-mode application, first limit  the amount of extended  memory
  258.  used  by  Paradox  or  BC++.  For  Paradox,  use its /extk command-line
  259.  parameter; and for  BC++, use its  /x command-line parameter.  Refer to
  260.  the Paradox or  BC++ documentation for  more information on  the use of
  261.  command-line options.
  262.  
  263.  
  264.  1.9 Important note for multi-tasking users
  265.  ──────────────────────────────────────────────────────────────
  266.  If you have loaded SHARE.EXE or  any equivalent (like the internal OS/2
  267.  sharing), you MUST keep  MTADPMI.EXE READ-ONLY. If you don't use any of
  268.  these  programs  (e.g. you  are not running under DV, Windows, OS/2 and
  269.  so on), you can make MTADPMI.EXE a normal file in the following way:
  270.  
  271.  ATTRIB -R MTADPMI.EXE
  272.  
  273.  [------------------------ END OF DOCUMENT ----------------------------]
  274.